home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / utility / cops605.zip / COPSINCE.DOC < prev    next >
Text File  |  1996-05-09  |  7KB  |  155 lines
  1. COPSINCE.DOC                         1                         Revised: 05/09/96
  2.  
  3. This program looks for all files in a particular subdirectory and copies all new
  4. ones to another subdirectory.  It is  typically  used  to  make  sure  you  have
  5. backups of files while  you're  in  the  middle  of  doing  something  to  them.
  6. Features:
  7.  
  8.   * You can copy all files updated since a given date or within the last
  9.     x-number of days.
  10.   * You can specify that newer files be copied regardless of date restriction
  11.     as long as the older version already exists in the subdirectory.
  12.   * You can define groups of file types, using DOS wildcard specifications
  13.     and copy only, say, text files or word processing files.
  14.  
  15.  
  16. Specifying parameters:
  17.  
  18. Parameters for this program can be set in the following ways.  The last  setting
  19. encountered always wins:
  20.   - Read from an *.INI file (see BRUCEINI.DOC file),
  21.   - Through the use of an environmental variable (SET COPSINCE=whatever), or
  22.   - From the command line (see "Syntax" below)
  23.  
  24.  
  25. Defining your own file specifications:
  26.  
  27. You can create your own file specifications for  copying  purposes.   Typically,
  28. this is done using an *.INI file (see BRUCEINI.DOC file) but it can also be done
  29. from the command line.
  30.  
  31. These definition specifications are made using the following syntax:
  32.  
  33.         /DEF filetype=filespecs
  34.  
  35. For example, if you want to specify a new grouping "WP", you can  define  it  to
  36. include something like the following:
  37.  
  38.         /DEF WP=*.WP *.WP5
  39.  
  40. Up to 20 file specifications can be made for a given group.   Your  COPSINCE.INI
  41. file can contain up to 10 groupings.  Once the group is defined,  you  can  then
  42. specify the name of the group on the command line and those are the  files  that
  43. will be grabbed.  By default, only two  file  types  are  defined  and  you  can
  44. override both of these if desired:
  45.  
  46.         /DEF ALL=*.*
  47.         /DEF TEXT=*.BAS *.BAT *.BI *.C *.DOC *.H *.REF *.SAS *.SC *.TEK *.TXT
  48.  
  49. Win95 notice:  As with most DOS-based utilities, this program doesn't understand
  50. the weird subdirectories and filenames that are possible under Windows 95.
  51.  
  52.  
  53. COPSINCE.DOC                         2                         Revised: 05/09/96
  54.  
  55. Syntax:
  56.  
  57.     COPSINCE [ from_dir | from_dir\filespec [ to_dir ] ] [ /TO to_dir ]
  58.       [ mm/dd/yy | -n | /COPY mm/dd/yy | /COPY -n ] [ /REPLACE | /-REPLACE ]
  59.       [ /ALL | /TEXT | /filetype ] [ /DEF filetype=spec [ spec ]... ]
  60.       [ /BEEP | /-BEEP ] [ /Q ] [ /Iinitfile | /-I ] [ /? ]
  61.  
  62. where:
  63.  
  64. "from_dir" is the subdirectory name in which the source files  are  found.   Can
  65. provide drive  and  path  information  if  desired.   Defaults  to  the  current
  66. subdirectory.  Alternatively, you can specify a filespec including wildcards  to
  67. limit the activity to one group  of  files.   If  you  specify  a  filespec,  it
  68. overrides any /ALL, /TEXT, /filetype specifications.
  69.  
  70. "to_dir" or "/TO to_dir" is the destination to which to  copy  the  files.   Can
  71. provide drive and path information if desired.  Initially defaults to "/TO=A:\".
  72. The "/TO" parameter itself is only required  if  a  from_dir  parameter  is  not
  73. provided.  The equal sign is optional.
  74.  
  75. "mm/dd/yy" or "/COPY mm/dd/yy" specifies the date from which you want all  files
  76. copied.  Initially defaults to today's date.
  77.  
  78. "-n" or "/COPY -n" says to copy all files updated in the last n-number of  days.
  79. Initially defaults to "/COPY -0"; all files created today only.
  80.  
  81. "/REPLACE" copies anything in the source directory  that's  either  not  in  the
  82. destination directory or is newer than the version in the destination directory.
  83. This is the default.
  84.  
  85. "/-REPLACE" reverses /REPLACE.  Only files that aren't in the destination  drive
  86. will be copied.
  87.  
  88. "/ALL" says to take all files (initially, a file specification of *.*).
  89.  
  90. "/TEXT" restricts copying to only those files that  are  known  to  be  straight
  91. ASCII files.  Initially, this is defined as any files  which  meet  any  of  the
  92. following file specifications:
  93.  
  94.         *.BAS *.BAT *.BI *.C *.DOC *.H *.REF *.SAS *.SC *.TEK *.TXT
  95.  
  96. Initially, the routine grabs the /TEXT specification by default.
  97.  
  98. "/filetype" allows you to invoke your own file specification.  You might want to
  99. have something like /WP (for *.WP *.WP5 etc files) or  whatever.   You  have  to
  100. define this filetype using a /DEF filetype statement.
  101.  
  102. "/DEF filetype=spec [ spec ]" allows you to create your own file specifications.
  103. Typically, this would be specified in your initfile.   See  "Defining  your  own
  104. file specifications" above.
  105.  
  106.  
  107. COPSINCE.DOC                         3                         Revised: 05/09/96
  108.  
  109. "/BEEP" gives you a beep when the program finishes.
  110.  
  111. "/-BEEP reverses /BEEP and is the default.
  112.  
  113. "/Q" turns off the file-by-file status report.
  114.  
  115. "/Iinitfile" says to read an initialization file with the file name  "initfile".
  116. The file specification *must* contain a period.  Initfiles are described in  the
  117. BRUCEINI.DOC file.  Initially defaults to "/ICOPSINCE.INI".
  118.  
  119. "/-I" (or "/INULL") says to skip loading the initialization file.
  120.  
  121. "/?" or "/HELP" or "HELP" shows you the syntax for the command.
  122.  
  123.  
  124. Author:
  125.  
  126. This program was written by Bruce Guthrie of Wayne Software.  It is free for use
  127. and redistribution provided relevant documentation is kept with the program,  no
  128. changes are made to the program or documentation, and it  is  not  bundled  with
  129. commercial programs or charged for separately.  People who need to bundle it  in
  130. for-sale packages must pay a $50 registration fee to  "Wayne  Software"  at  the
  131. following address.
  132.  
  133. Additional information about this and other Wayne Software programs can be found
  134. in the file BRUCEymm.DOC which should be included  in  the  original  ZIP  file.
  135. ("ymm" is replaced by the last digit of the year and the two digit month of  the
  136. release.  BRUCE512.DOC came out in December 1995.  This same  naming  convention
  137. is used in naming the ZIP file that this program was included in.) Comments  and
  138. suggestions can also be sent to:
  139.  
  140.  
  141.                 Bruce Guthrie
  142.                 Wayne Software
  143.                 113 Sheffield St.
  144.                 Silver Spring, MD 20910
  145.  
  146.                 fax: (301) 588-8986
  147.                 e-mail: bguthrie@nmaa.org
  148.                 http://hjs.geol.uib.no/guthrie/
  149.  
  150. See BRUCEymm.DOC file for additional contact information.
  151.  
  152. Foreign users:  Please provide an Internet e-mail address in all correspondence.
  153.  
  154. 
  155.